Inside Macintosh: Processes

Chapter 5 - Notification Manager / Notification Manager Reference

Notification Manager Routines /

NMRemove

To remove a notification request, use the NMRemove function.

FUNCTION NMRemove (nmReqPtr: NMRecPtr): OSErr;

nmReqPtr

A pointer to a notification record.

DESCRIPTION

The NMRemove function removes the notification request identified by the nmReqPtr parameter from the notification queue and returns a result code.

SPECIAL CONSIDERATIONS

Because NMRemove does not move or purge memory, you can call it from completion routines or interrupt handlers as well as from the main body of an application and from the response procedure of a notification request.

ASSEMBLY-LANGUAGE INFORMATION

The registers on entry and exit for NMRemove are

Registers on entry
A0	Address of NMRec record

Registers on exit
D0	Result code

RESULT CODES

noErr	0	No error
qErr	-1	Not in queue
nmTypErr	-299	Invalid qType (must be ORD(nmType))